home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / admin / xinetd.2 / xinetd / xinetd.2.1.7-linux.4 / INSTALL < prev    next >
Encoding:
Text File  |  1996-01-24  |  3.3 KB  |  95 lines
  1. $Id: INSTALL,v 1.2 1995/05/02 18:15:58 chuck Exp $
  2.  
  3. 1. Distribution
  4.  
  5. xinetd is distributed in shar archive kit form.  After all the archives
  6. are unpacked, you should end up with the following directory structure:
  7.  
  8.     INSTALL
  9.     README
  10.     compile-src
  11.     ./xinetd
  12.     ./libs
  13.     ./libs/include
  14.     ./libs/man
  15.     ./libs/lib
  16.     ./libs/src/{sio,pset,misc,xlog,timer,pq}
  17.  
  18.  
  19. ----------------------------------------------------------------------
  20.  
  21. 2. Installing xinetd
  22.  
  23. The compile-src script will compile the libraries and xinetd.
  24. "compile-src -help" will list all available options.
  25. It knows about some operating systems. When you invoke it, it will ask
  26. you if your OS is among those it knows about. If so, all you need to do
  27. is type the OS name.  If you have a different OS, compile-src will try
  28. to configure xinetd appropriately.
  29.  
  30. The script will also ask you questions when it can't figure out
  31. something.  For every question that it asks, there is a command line
  32. option, so in case you need to run the script more than once, you can
  33. use the command line option to avoid having to answer the question
  34. multiple times.
  35.  
  36. It is recommended that every time you make changes to xinetd or to the
  37. libraries it uses, you cd to the top level directory (the one
  38. containing the directories "libs" and "xinetd") and run the script
  39. compile-src. This script invokes "make" with arguments that override
  40. variables defined in the Makefiles.
  41.  
  42. When the compilation is over, the xinetd executable will be in the
  43. "xinetd" directory. If you want to install it in one of the system
  44. directories, cd to the "xinetd" directory and type:
  45.  
  46.     make install INSTALLDIR=<install program here>
  47.     make install.man MANPATHDIR=<install man page here>
  48.  
  49. For example:
  50.  
  51.     make install INSTALLDIR=/usr/local/bin
  52.     make install.man MANPATHDIR=/usr/local/man
  53.  
  54. The reason for putting the program in a directory like /usr/local/bin
  55. is that this is not a program that is only useful to superusers.
  56.  
  57.  
  58. ----------------------------------------------------------------------
  59.  
  60. 3. Customizing xinetd
  61.  
  62. Most of the behavior of xinetd is determined by constants defined
  63. in the xinetd/config.h header file. Those constants are conditionally
  64. defined and can be overriden by creating the file xinetd/customconf.h
  65. and invoking the compile-src script with the -custom option.
  66.  
  67.  
  68. ----------------------------------------------------------------------
  69.  
  70. 4. Epilogue
  71.  
  72. Here are a few things worth mentioning:
  73.  
  74. 1. You can use the program "itox" in the "xinetd" directory to convert
  75.     inetd.conf to a xinetd configuration file. The program works as a
  76.     filter, i.e. 
  77.             itox [-daemon_dir dir_name] < inetd.conf > xinetd.conf
  78.     The -daemon_dir option is useful in case you are already using tcpd for 
  79.     access control. It specifies the directory name where tcpd expects
  80.     to find the daemon programs.
  81.     The itox program will also be compiled by the compile-src script.
  82.     
  83. 2. A sample xinetd configuration file is included: xinetd/sample.conf 
  84.  
  85. 3. I have been using xinetd on a Sun SparcStation running SunOS 4.1 and 
  86.     I have compiled it (but not used it) on a DECstation running Ultrix 4.2.
  87.  
  88. 4. You may find the libraries useful in their own right. They all come
  89.     with man pages that explain what the library functions do.
  90.  
  91. 5. You can send comments/bug-reports to panos@cs.colorado.edu
  92.     The file BUG-REPORTS in the "xinetd" directory contains instructions 
  93.     on what to include in a bug report.
  94.  
  95.